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Updated the semantics of the "Stop" command. 
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Updated "NO-EOF" semantic. 
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Added FREQUENCY to NDL station attributes. 

Added “the command must be prefixed" sentences 
Updated SYSTEM explanation. 

Updated TRACE explanation. 

Updated TRANSLATE explanatione 

Updated ZIP syntax. 

Updated Semantics. 

Added NO SESSIONS X; AUTO FIRE X, FILLER X(12), LINE 
NUMBER X(8) and descriptions to JOB FILE listing. 
Changed String length from X(80) to X(72). 

Updated "Note: The job file" paragraphe 

Added 8 = NO.SESSION and 9 - AUTO FIREUP to SAMPLE 
JOB FILE *FIELDS. 

Updated TEXT FORMAT table. 
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Replaced SPO with ODT throughout. 

Added (the Host ODT is considered to be a Remote ODT). 
Added HARDWARE and START to control statements only at 
host ODT. 

Replaced subtract with delete. 

Replaced subtracted with deleted. 

Rewrote HARDWARE section. 

Added "the "RD" program is active" paragraph. 

Updated syntax. 

Updated ODT paragraph. 

Added “the Host ODT" to CON paragraph. 

Rewrote "command is valid" paragraph. 

Updated Examples. 

Updated syntax, 

Rewrote Semantics. 

Added SIGN OFF paragraph, 

Added Semantics, Default, Examples, and Note. 

Added START section, 

Added SYSTEM section. 

Added LIST to syntax. 

Added Default and Examples. 

Changed user to usercodes in “the station is currently 
‘logged on" paragraph. 

Updated "Any input" paragraph. 


A-1, 2 Rewrote APPENDIX A - JOB FILE section. 


Deleted SAMPLE JOB FILE section. 
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GENERAL DESCRIPTION 


The Supervisory Message Control System (SMCS) program is intended 
to be the supervisor for a data communications software systea 
which includes such Burroughs software as CANDEs RJE» HASP and 
other on-line packages of either Burroughs or customer origin. 
SMCS also serves as a base which can be easily augmented to meet 
any customer requirements for a speciatized or more inclusive 
systems supervisor. 


MAJOR FEATURES 


SMCS provides alt of the features of the previousty reteased 
[ilustrative MCS CMCSII) and several new features that 
considerably expand the flexibility of remote terminals. MCSII>» 


for examoter provided message switching (terminal-to-ternminale 


terminal-to-090T» ODT-to-terminal)» attachment to user programs 
via aeoremote files information about the remote networks and 
internal (MCS) error reporting as some of its basic functions. 
The new SMCS witl provide att of these features in addition to 
aliowing users to: | 


= Designate terminals as remote operator display terminals 
COOTs) and have access to MCP cosmands and information 
about the status of the syster. From terminals 
designated as unrestricted» jobs can be executed as if 
the remote stations were an ODT. This type of terminal 
is referred to as a remote ODT station. 


= Designate teraminats as controllers which enables certain 
network reconfiguration commands from that terminal. 
This type of terminat is referred toe as a controiler 


Station. 
= Participate in the obasic file security mechani sa 
supported by the MCP and spawn jobs tn accordance with 
the requirements of file security. Furthermore,e SMCS 


supports a job file for storing execute instructions that 
are tailored to a particular user*s or oprogram"s needs 
and a mail file for storing information that is returned 
from a user program or a host systewe SMCS automatically 
checks the job ftie for speciat execute requiresents and 
allows users to check the mail fite for inforrgation that 
1s received from a host system or an application program 
CPROGRAM-PASS input). 


= Allow auser at a remote terainals through the PASS 
command and the PROGRAM-PASS sessage interfaces to 
request a function of a program in the host systea 
without signing on to the progran. In this ways» for 


example» an edited file may be transferred from the host 
System to a remote system via the RJE interface while the 


r 
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user continues to edit another file. 


= Receive expanded network reporting that is tailored to 
individual remote stations (designated as restricted) or 
that tnvoives the whole network and the operating systes 
Cunrestricted stations). 


= Initiate system tracings from unrestricted stations only» 
to take advantage of the debugging facilities provided by 
the B1800/B1700 operating systea. 


REMOTE OPENS 


One of the major facilities provided by the SMCS is the execution 
of apptication programs which open remote files. The SMCS aids 
in executing these prograas by checking an internal job file> 
described sore fully itn Appendix Ape for speciati instructions 
about how the job should be executed: @eGee Priority» number of 
remote stations alioweds fiie equations» etc. 


There are two forms of executions one secure and the other not» 
that are aitowed by SMCS. Only remote ODTS may use the un~secure 
form of execution. In addition» SMCS provides a mechanisa for 
passing information between remote terminals and jobs that are 
executed from a remote station. These facilities are defined as 
follows: 


ZEXCECUTED 


A station using this method of execution must be logged onto the 
system by the USER <usercode>/<password> syntax if the station 1s 
not aresote OOT station. After entering 2EX <program name>s the 
specified program will be spawned. No reference is made to the 
job file. If a station tCist is present tin the remote file open 
and all of the stations are not controlled by SMCS» the station 
list is useds otherwiser only the initiating station ts approved 
in the remote file open request. 


2IGN ON 


A station which may or may not be logged on enters the following 
commande 


SIGN ON <program name> 


If <program name> is not running» itt will be spawned including 
any specifications in the job file. Atl stations Cup to the 
limit declared in NUMBER.OF.STATIONS) entering SIGN ON for that 
program will be approved in the open. If the program is running» 
its remote file is open and the nuaber of stations currently 
attached does not exceed NUMBER.OF.STATIONS deciared in the opens 
then the station witt be attached. 
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If» at either open or attach time the file to which the 
station€s) must be attached already has as many stations attached 
as declared in NUMBER.OF.STATIONS» then a new copy of the progran 
wilt be zip executed and the rewaining stations sarked as waiting 
for Se open. This process is recursive for each open or 
attach. 


The effect of this method is that NUMBER-~OF -STATIONS CNST in file 
equates) in aremote file open wild determine how sany stations 
can be handled by the progran. 


NST 
NST 


1 => 1 copy of progras per SIGN ON 
5 => 1 copy of program per five SIGN ONs 


At SIGN OFFs the station is detached from the file. If this was 
the last station on the files then an EOF branch is sent to the 
file Cuntess the job fiie NO EOF specification exists). 
Typically» an EOF branch on a remote file read will cause the job 
to perform a STOP (Cgo to EDJ). 


PASS 
A station enters 
PASS <prograsm name> <string> 


<Program name> is treated exactly as in SIGN ON with the 
exception that the station that PASSed is not approved in the 
opens nor is it attached if the program was already running. 


SMCS notes that this station has successfully PASSed to this 
program and tater PASSes from this station will not cause a new 
copy to be zipped. However» PASS to this program from a station 
which previously had not PASSed to it wilt cause SMCS to 
determine the need to zip execute another copy dependent upon 
NUMBER.OF STATIONS exactly as in SIGN ON above. 


When a station enters BYE» it is removed from the list of known 
PASSers on the files to which it PASSed. This command its similar 
to SIGN OFF except that no detach is sente If any of these files 
then have no station attached Ceither by PASS or SIGN ON)» then 
an EOF branch is sent to the files unless the job file 
specificatione NO EOFs extsts. 


DIL A alien iN Wane Onin ae el eee ee Delfcon eM RL eee 
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Note: If a program which opens a remote file (such as CANDE) is 
executed from the host ODT» then SMCS will approve its 
open giving it as many stations as it cane disallowing 
only those stations which are already active through 
SNCS. It is recommended that this not be done since the 
SMCS would then have no way to retrieve those stations 
Without each one being explicitly SIGNed OFF. 


STATIONS 


The SMCS allows for the definition or creation of a station as a 
remote ODT via the MAKE or CHANGE commands or by definition in 


the station section of the network controtter. A station is 
considered to be a remote ODT if its frequency (transmit) is 
greater than 249. Only a remote ODT station say initiate 


restricted control statements (the Host OD! is considered to be a 
remote ODT). Work stations are forced to log on with the USER 
command before making use of SMCS capabilities. Until the user 
fogs on» the only command valid from that station are HELP» ID» 
REPORT» SEND» and TRANSLATE. 


RELATED DOCUMENTATION 


Name Number 
B1800/B31700 Message Controi System Interface Pe Se 2212 S447 
B1800/81700 Network Definition Language Pe. Se 2212 5223 
Bi800/B1700 NOL/Library | Pe S$. 2212 5215 
81800/81700 Datacomm Audit Pe Se 2212 5421 
81800/B81700 Systems Software Operational Guide 1068731 
B1700 Network Definition Lauguage (NDL) 1073715 


Reference Manual 
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OPERATIONAL PROCEDURES 


SMCS contains sost of the basic building blocks which would be 
required» in one form or anothers for a comprehensive MCS. Every 
effort has been made to keep the SMCS as modular as possible» so 
that changes may be readily effected. The sodularization aiso 
renders the program a more readable document. 


The internal file name of SMCS* remote file is "REMOTE®. When 
executeds a file equation may be used to equate "REMOTE" with the 
desired file name The externat file name exoected is 
"MCSREMOTE*. | 


CONTROL MESSAGE 


Control messages can be entered through remote stations onty. 
The syntax 1s shown bellows 


Syntax: 


i-- <signat character> er! t-- <restricted control statement> --1 


Semantics: 


The signal character is **”" unless changed by the SIGNAL coanand 
and is used to communicate to the SMCS when the station has been 


signed on to some other program. A station with frequency 
(receive) greater than 249 is considered a controtier station. 
These Stations may enter both restricted and unrestricted 


commandss other stations can use only the unrestricted commands. 
Note that any control statement is free-field fora. 


Statements: 


The fotllowtng are unrestricted controt statements avaitabde at 
any stations 


BROADCAST 
BYE 
CONTINUE 


PASS 
READY 


SEAT ey biel ine 
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REPORT 
SEND 

SIGN OFF 
SIGN ON 
STATUS 
TABS 
TERMINATE 
TRANSLATE 
USER 

2 


The following are restricted control statements available at 
remote ODT stations: 


ZIP 
NEWS 
SYSTEM 


The foilowing are network configuration controt statements 
available at controtier stations: | 


ATTACH 
CHANGE 
CLEAR 
DETACH 
DUNP 
MAKE 
MOVE 
REMOVE 
SIGNAL 
TRACE 


The following are control statements available only at the host 
ODT: 


CLOSE 
DYNAMIC 
HARDWARE 
INITIATE 
STOP 
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SYNTAX CONVENTIONS 


The following command descriptions make use of ae siaple 
diagrammatic convention for displaying att the possibte vatid 
syntax combinations. 


€ ) Optionat command part. The abbreviation in the 
exaaple is “Z*. If not presents there is no 
abbreviation atlowed. 

< > Syntax iten 


Examples: 


>e eave wvevevweaueooaea <NCP control string> eesewreecaaneewoaonvocooeoawcoere=> Z 
be" ZCEP) <3) 


>@= MCAKE ) aan @ €isn> SS 2 SSB BAe en aenanenaananaanaean READY aeoneaae)> ff 
I-- <station name> err->fio~ NOT --i t-~> ENABLED --! 
i-- <usercode or [D> ==>] 


CEREAL n) ae enc NEA UCP CTA ETC 


if 
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COMMANDS 
ATTACH 
DETACH 
Syntax: 
>e2e ATYTCACH) SSS SFB 2B SVS GAB TSAH HT eF ee sees ee asses onaneaawaveaeae eae) > 
i E-- TO -7>i I I-* PROGRAN --- <job number> eee--->>I 
i i | Il-- <program name> -~>!i i 
I-DETCACH) woee--e-=--->1 1 
i-- FROM =>] { i 


f-- FILE 7-- <remote file number> ~-~>] 
l-- <reaote file name> -->!] 


[ec eer cesceeees » ewecewooeecoeea | 


>> een eeeae == ap a2 an oe oe oe Oemeenene Be @ @ = <l sn> wew ware ewantaeoeweoewoecocoe=>5 Z 


l-- STATION -->!] i-- <station name> -->] 


Semantics: 


Both commands are valid from ati controller stations. See SIGN 
ON and SIGN OFF for normal stattoncto-progranm attachment. 


ATTACH and CETACH commands are used to add or detete stations 
from a given remote file. 


These conmands are used to modify a given remote file station 
dist. The stations to be added or deteted aust follow the rules 
set up In Pe Se 2212 S4475 NCS Interface» for the ATTACH and 
DETACH messageSe 


If a program name is used» then the first remote file in the 
remote file table of SMCS its the subject of these coamands. If 
mo program or file is specifieds then the station is attached Cor 


detached) to (from) SMCS*s remote file. 


Example: 


ATTACH PROGRAM EDITOR 35495. 
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BROADCAST 

Syntax: 


> @ee2ece BROC ADCAST) Sean eoaneaneaaaan <message> Sea esnecoanaanwounnaaveareoe) f 


Semantics: 


The BROADCAST command sends a given sessage to alt active SMCS 
Stations °7~ those which have togged on»s used the ID commande’ or 
those whose state is not unattached state. It is valid from atl 
Stationse : 


i 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP | Bi000 SNCS 
SANTA BARBARA PLANT Pe So 2219 0482 CF) 
BYE 

Syntaxs 


Semantics: 


This command logs the current user off SMCS. It is valid fron 
ali stations except the host ODT. [f the station sending the 
command is the last currently active station and a STOP command 
has previousty been entered» SMCS wilt terminate after processing 
the BYE. If the station was marked as having PASSed to a remote 
file and this is the onty Cor Last) station so marked» SMCS willl 
Cause an “EQF* branch on the PASSed remote fite. | 
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CHANGE 
Syntax: 


>eeeneeea CHACNGE ) Se eave naeae sen neananea <isn> eee eee one ea 2 a2eee22)>> 


f-- STATION -->1! I-- <station-name> <-->! 


I-- TRANCTRANSNIT) s2-cecccenennneennn->] f-- TO =>! ! 
I-- ADDRESS -ocee nnn enn n nese enn enn--->} i 
! Im- (RECEIVE) --->1 
i I-- (TRANSMIT) -->1 
I-- FREQUENCYCRECEIVE) soecrecernnen--->{ 
l-- FREQUENCYCTRANSMIT) -s-2see-------->] 
P-- RETRIES core cce nn nne nec ee nn nneen--->] 
l-- PHONE sor ece en nn enn enn e een n nn nnn-=> | 
Po- READY sores enn e nen n enn e nn nn nn reeeene QN cnn e ener enn enenenennt 
l-- GOODRESULTS ->1 !-- TO -->! t-- OFF <-->! 

I-- DIAGNOSTIC <-->! f-- TRUE -->I 

I-- LOGICALACK ==>! l-- FALSE =->1 


{-- 1 eee) | 
j-- 0 onoaae > | 


For <variable> value format on the CHANGE message» see Pe. Se 
2212 54470 MCS Inter face. 
Semantics: 
The CHANGE cormand is only vatid from controtler stations and its 
used to dynamicatly change various NDL station attributes. The 
NOL attributes are changed appropriately to the new vaiuee 
Exaaples: 

CHA 5 PHONE 12374567 

CHA STATION ST2 READY ON 


CHA STATION 4& ADDRESS TO "D&" (This command changes both receive 
| and transmit addresses to D4.) 


upitogenli slate vats Ai set TS re CR a re a a 
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| COMPUTER SYSTEMS GROUP B1000 SMCS 
SANTA BARBARA PLANT P. Se 2219 0482 (F) 
CLEAR 
Syntax: 


I---- <resote file name> -->! 


Semantics: 


CLEAR is valid from ail controiter stations. It disabies flags 
indicating the file is waiting for a response. Whenever a_ file 
state 1s waiting for external response (such as attach reply - 
see Pe Se 2212 54475 MCS Interface)» and the program responsibte 
for the response does not respond (O0Sed or program error)» one 
should invoke this command to reset the file status. 
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CLOSE 

Syntax: 


CLOSE SO @8 @ © OC SS 2 OS S BBV SVDBHVVD|AVHVAV’DSDDSVHVAKVSSR FVSHAA*SSHVVASBAVSBA*S*S*VSIBA*A*B*A*SHA*AA“AO*BO®*OGSG 1 


Seaantics: 


The CLOSE command is used to close the JOBS file. The JOBS file 
will only stay closed until SMCS needs to access it again. This 
command is valid only when entered at the ODT. 
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CONTINUE 

Syntax: 


CONTINUE SLPS DSSS DSM AA SOT OT ABFA T ee T ee was ewee ewes eee eeeee | 


Semantics: 


The CONTINUE command is a new work station commande The CONTINUE 
command ts used to continue a step macro which was suspended by a 
“WAIT CONTINUE™ step macro conmand. 


at 
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DUSP 

Syntaxs 

Pe cena aenaaee DUMP ee 228 2228 2BB CBE BLOB BHA BOAe su 2 en anaanaavavaavenn) 
Semantics: 


The DUMP command is valid from either a controtiter station or the 


host ODT. It causes the SMCS to zip a *<SMCS job number> DM 
command” to the MCP which creates a duap file and responds’ to 
SMCS with the correct file naswe/nuaber. SNCS sends a gsessage 


containing this file name/nusber to the originating terminal. 


Note: This command is normally used only for network and 
program debugging. 
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DYNAMIC 
Syntax: 


> eesenaase DYN CAMI C ) See aaan eee Be eee ewer eee eas eens awocwreeeee=> ff 
I-- ON --->) 
j-o OFF o> | 


Semantics: 


Dynamic ts valid from the host ODT only. If “OFF*® is entered» 
SMCS will automatically make "not ready* any station which incurs 
an exception (such as retry consecutive timeouts from having been 
turned off). If "ON" is entered» then stations will not be 
automaticalty made "not ready*. If no option is entered» the 
Current setting of DYNAMIC is reported. 


ne 


¢ 


BURROUGHS CORPORATION 


3-10 


COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP | B1000 SMCS 
SANTA BARBARA PLANT P. S. 2219 0482 (CF) 
EILE 

Syntax: 


Peeeeneae FCILE ) asaeaaneae 


Semantics: 


This command 
specified (by 
user staton 

this command. 


Exageples: 


Inputs 
Responses 


(<usercode>)/<filenagme> se eaevanaanvavoenzae) ff 


ts used to display current inforasgation for a 
name) file. It is valid from all stations. The 
need not be logged on or signed on to make use of 


F CSMCS)/TESTFILE 

"CSMCSD/TESTFILE® IS A PRIVATE DATA FILE OF 
150 RECORDS €90 BYTES» 20 PER SLOCK) IN 

8 BLOCKS (80 PER AREA» 1 AREA) CREATED ON 
01/05/78» LAST ACCESSED ON 

01/12/78 CACCESS SECURITY {5 eee OUTPUT) AND 
CURRENTLY IN USE BY 0 USERS 


BURROUGHS CORPORATION CONPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP Bi000 SMCS 
SANTA BARSARA PLANT Pe Se 2219 0482 CF) 
HARDWARE 

Syntax: 


> eeeeee2eoea HARDC WARE ) =e oe LP em ee ew ee samt ee enmeesreewtecaaaecesceceaee@)> § 


l---> <attribute> --->] 


Semantics: 


This command provides the capability to “adjust™* the SMCS*s 
utilization of the system's Line Printer “print tine size*® 
attribute to take advantage of a 132 position printer if it is 
available. Primarity the SMCS uses the line printer for either 
direct printer-tracing or for printing the disk-trace file when 
required. 


attribute an integer representing the actual print 
line of a tine printers either *%120* 


or "132*°*. 


no option specified is the same as a 
“status” requeste 


nufdi option 


De fault: The System’s default wiitl be "120" positions and 
is established at initialization tise as required. 


Example 1: (Change the Line printer attribute to "132". ) 
Input: *7-- HARDWARE LP 132 
Reply: s-"- LINE PRINTER ATTRIBUTE CHANGED TO 132 

Example 2: (Obtain current line printer size attribute.) 
Input: -"- HARD LP 
Reply: e-- CURRENT LINE PRINTER ATTRIBUTE IS 132 


Note: This change is considered "permanent®3 until such 
time as it is changed via another entry of this 
command. 


Crea Big ne salse tstine diay So Soh Tin tS Gilt Saas 6 atts A 
ee z PARI STE CL Pena ere TTT RCE TREN RO PREM St eT eR 
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HELP 

Syntax: 


Semantics: 


HELP is valid from all stations. It initiates a display to the 
user of aii comuands vatid for that station at that time. The 
display witt vary depending upon the type and current state of 
the station. | 


ia hier re, ela rare Unina acater settee 
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INITIATE 
Syntax: 


Semantics: | \ 

This command provides the capability to "start up a job froam the 
host ODT in Lieu of being forced into an auto-start sode by or 
doing a PASS/SIGN-ON from a terminal. Using this command» a job 
can be spawned selectivedy for any nuaber of reasons and requires 
no further action from the operator. The specified job witl be 
Spawned in the same way as if it had been auto-started by SMCS», 


no stations are initiali attached and any station spawned can 
thereafter either PASS or SIGN-ON at wild. 


program id = program id as specified in JOBS file. 


De fauit: No defautts. 
Example: (Start up *SYCOM".) 
Inputs *""- <smcs job #> AX START SYCQOM 
Reply? --- PROGRAM SPECIFIED HAS BEEN STARTED 


Notes: Nonee 
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1089 

Syntax: 


>weeevenee JCOBS ) S888 OOOO OO 8ST OCB OCTET BLAST Be TES THM BBHB ABH Beeeaeew)> fs 


Semantics: 


This command is valid from alt stations except the host ODT. It 
returns inforgation about alti jobs in the host» both active and 
scheduled. 


JOBS allows a non-remote ODf station to observe the total 
activity on the host» not limited by the security imposed by 
usercode. Since this is a passives unsecured MCP communications 
it will not allow the nonvremote ODT station to affect the host. 
activity. This facility can be of use in deciding whether or not 
the system will bear another job. 


SMCS effects the JO8S command by sending to the MCP the following 
commands tn one ZIP: 


MX> WS=2 Mie 
The responses wilt be from the MCP. 
If however» the "RD" program is currently active and known to the 


SMCS» ait will be sent the *J085" command string and the response 
widi come from that program. 
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COMPUTER SYSTEMS GROUP B21000 SMCS 
SANTA BARBARA PLANT — Pe Se 2219 0482 CF) 
LOGON 

Syntax: 


LOGON Seana Ben enen ADD Banana naanane <LOG-QN DEFAULT COMMAND> esaoveeoee | 
i oe i 
Pere~ CHANGE e-eern i 
| i 


j«2cro= List S28 Bes SATs ease eenenacaeasenaewananevece= | 


{ «<c<-- DELETE aan wee se Tae Sane ee ee eae ence nee ecooeeaoeaecece | 


Semantics: 


The “LOGON™ coamand is used to add» changes deletes and list the 
defauit logon command. The default log7on command ts processed 
after the logron with the USER command ts comotete. If a command 
is entered with the USER command» that command %s processed 
first» then the default logon command. The default tog-on 
command is restricted to 90 characters in tength. In order to 
use this feature» program switch 3 must be set to 1 (same switch 
for macro feature) and the user must be logged on with the USER 
commands» SMCS does not scan for “"{" or 73" tin the default loag-on 
command. 
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MACRO 


The MACRO command adds» changese or Lists MACRO procedures stored 
in the SMCS/DIRECTORY file. The MACRO command is valid from atl 
station types. The station must be logged on with the USER 
cogmgsand and program switch 3 must be set to ile MACRO procdures 
are stored under the usercode with which the station is togged 
on. Refer to Appendix D for more inforsation on MACRO procedures 
in SMCS. 


Syntax: 


MACRO ----- ADD ceecccen---- <macro name> err""" <macro text> errcrr--! 


i 1 
f-- CHANGE -<-1 
I 


I-- DELETE --------- <macro name> -----+ eee n--- 2-22 -------] 


! 
l-- LIST ------1 
! 


Semantics: 


ADD The ADD option writes <macro text> into a portion 
of the SMCS/DIRECTORY file under the usercode of 
the Station and <macro name>. 


CHANGE The CHANGE option changes an existing MACRO 
procedure » <macro mname>s to <macro text>. The 
MACRO procedure to be changed is deleted and 
rewritten in the SMCS/DIRECTORY file. Atl 


restrictions listed under the ADD option apply to 
the CHANGE option. 


DELETE The DELETE option deletes an existing MACRO 


procedure» <macro name>» from the SNCS/DIRECTORY 
file. | 
LIST The LIST option displays a directory listing of 


all existing MACRO procedures for the stations's 
usercode or lists the contents of a specific MACRO 
procedure. If <macro name> is not specified» a 
directory list of ali MACRO procedures for the 
Station"s usercode is displayed with the date and 
time that the MACRO procedures was created. 


<macro name> <macro name> is the token used to reference the 
MACRO procedure. It must be ten characters or 
fess beginning with an alphabetic character. 


<macro text> <macro text> is the MACRO procedure that is 
invoked when the <macro nase> is referenced. 


BURROUGHS CORPORATION 
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Examples: 


PLANT Pe Se 2219 O482 CF) 


<macro text> can be up to 23 tines of texte The 
control string that is zipped as a result of 
invoking the MACRO procedure is invoked sust be 
2000 characters or fess. Coluan 80 ts’ reserved 


for step macros and must be blank. 


MACRO ADD COBOL 
CO P WITH COBOL> 
FILE CARDS DSK NAME P=S; 
FILE LINE U.N NO HAR NO ATP NAME #P3 


MACRO CHANGE COBOL 
CO P WITH COBOL; 
FILE CARDS DSK NAME Cs 
FILE SOURCE NAME S;3 
FILE LINE UeN NO HAR NO ATP NAME #P;3 
MACRO LIST 
MACRO LIST COBOL 


MACRO DELETE COBOL 


pe ey as aia ara ephedra aii ace deeb alight eat Usa Stes gh hag ae ih ola stifle Neh leah tn ths eh ahs UY id | Uc a a aa id la ea Rc ae a lashde, cop De ena aca 


| BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP 81000 SNCS 
SANTA BARBARA PLANT | Pe Se 2219 0482 CF) 
MAIL 
Syntax: 


peewee MCAIL) OOO 8 OOS OO OS COS 288 OBS BATE OBE DBF BFF Bees seeesaeceseore)> f 


jeo- €<id> Se wave ee 2eaavecoeezeece > | 


{-- <string> sanwen) | 


Semantics: 


MAIL is valid from all stations. The formats and responses are 
Shown below. See Appendix 8B for an explanation of the amatl 
system. 

MAIL Returns current mait count for that station. 


If the station is the host ODTs then the 
totai MAIL fide count is displayed. 


- MAIL <id> Returns current mail count for <id> if it is 
: logged on. 


MAIL <id><string> Places <string> in mail file under <id>. 
<String> is not sent to any station. 


Se ee Tao RCM TM ee CR Re RAT ce 


SURROUGHS CORPORATION COMPANY CONFIDENTIAL 
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MAKE 

Syntax: 

>Peweaecoe MAKE OO 8 OS © 86S 8 28 BS 2O 288 OBTDBEOHHBLLOE OBS BABB ABABA®eFZe2222)5))> 


l-- <station-nase> ~-->! 
>> 22 SIGNAL <single char acter> Se ®ceceneveeeecovasevaeneoananmaae > I 
> > Cae see Se Seen Bean eeanatsaeneaneaaaan READY sa a2 enanecananaeve> J 
$e" SCROLL REVERSE -->1 


Semantics: 


The MAKE command achieves the same effect as using the CHANGE 
command to change a subset of the station attributes. It changes 
whatever station attribute ts specified by the user. 


The station SIGNAL option is valid from any stations for itself 
ontys and is only permitted when that station is "signed-on" to a 
program such as_ SYCOM. The new station signal character is 
effective onty during its attachment to that programs at 
signoff» that station's signal character automatically reverts 
back to the SMCS signal character. The onty restriction for a 
Signal character is that it cannot be a period *."5 SYCOM 
requireszent. 


READY is valid from all stations and sets STATION.READY to O if 
NOT tts specified. Otherwise» the attribute is set to le NOT 
READY is valid from controller stations only. 


ODT is a valid attribute change only from the host ODT. This 
request initiates a change request to the network controller for 
the specified STATION to set FREQUENCYCTRANSMIT) to 250. If no 
more remote ODTs are altowed»s then a message is sent to the 


terminal to inform the user of this restriction. 


SCROLL REVERSE and NOT SCROLL REVERSE are vatid fron att 
stations» but the station specified must be that of the 
requestor. The station sust not be in forward scrotl mode. 


Note s Forward scroil mode is disabled by entering “?-" at the 
Station. ' 


Ys sca cavuein peter sales amber ha teich cisaitaert ic innemAmrin the shy incidkecs bebe Stat Hay ia legins lane nears! Sb aif tebe un ocruiis tanbines dea dyed tata 
Se re nee RET ey Cree EG RT ERE ME RN te ee RENE Ln ere 
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SCROLL REVERSE causes ati input from att stations (Cand the 
responses) to be scrolled down in the following manner. 

1. Input is received by SMCS. 

2e Cursor is positioned at teft margin of third line. 


32 Line insert is performed (This scrolls down the entire 


screen). 

4. Input is then rewritten on the third line. (This echo 1s 
to maintain a history on the screen of input and associated 
outpute ) 


Se Cursor is positioned at home. 
6. Output is sent by SNCS. 
7. (Cursor is positioned at teft margin of third line. 
8. Line insert is performed. 
9. Output is written. 
10. Cursor is positioned at home. 
CON is a valid attribute change from all controiter stations and 


the host ODT. A change request is sent to the network controlier 
to change the value of FREQUENCYCRECEIVE) to 250. 


end 
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BOVE 

Syntax: 


> MOVCE ) ow @ <nuaber> SOS See ATE Tee BGeF ee Be wee Bees eee ee Fee eeee >> 


fe- ALL w-->1 I-- FROM -">1 f-- STATION ==>! 


>> ween <isn> Be eaoeeoononen eae ee eee @ TQ SOA BAD GQeesdaas 2Qeanaaaoaoanveae >> 


i-- <stationtname> <-->] i-- STATION ==>! 


I-- <stationnane> <-->] 
Semantics: 
MOVE its valid from all controtler stations and enables a station 


to rewroute messages. It re-queues the output of one station 
into the output queue of another. : 


BURROUGHS CORPORATION | COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP B1000 SMCS 
SANTA BARBARA PLANT Pe. S$. 2219 0482 CF) 
NEWS 

Syntax: 


>= NCEWS) OO OOS OP OOS CS 8 OFT S8S BOS CCHS SEECSS BAT TF BG eT eases eneecezeee)> f 


f-r- - (minus stgn) e-2-=->1 
joo <string> wseeneceoeeeces > | 


Semantics: 


This command is valid from ail stations. It displays or changes 
the message displayed when a station logs on. If no option is 
supplied» the current news message is displayed. If "-"* (Ceainus 
Sign) is supplied» then the news buffer witli be cteared. If 
<string> its supplied» then the news message is changed to 
<string> and displayed. NEWS - and NEWS <string> options are» 
howevere onty valid from aremote ODT. 


Examples: 


Inputs NEWS PACK DC IS NOW ONLINE 
Responses NEWS: PACK DC IS NOW ONLINE 


Input: NEWS = 
Responses NEWS BUFFER CLEARED 


Inputs N 
Responses NEWS: <current message> 


eer a sa ee 
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SANTA BARBARA PLANT Pe Se 2219 0482 CF) 
PASS 

Syntax: 


Peees2eeen PCASS) == <progr am id> se wae <string> eseaveweewvoececcoorer= > 


Semantics: 


This command is valid from all stations except the host OD!» 
however» the station must be logged on via the US command if the 
Station is not a remote ODT. The <program id> must be declared 
in SMCS/JOBS (see Appendix A). 


<String> is passed by a PROGRAM=PASS message» depending upon the 
protocol type in the open received froma the program <progran 
Mmame>. See Appendix C. 


The purpose of the PASS cosmand and PROGRAM“PASS message 
interface is to atlow an operator at a terainal to request a 
function of a program in the host system without signing on _ to 
the progran. In this way» for example» an edited file may be 
transferred from the host system to aremote system via the RJE 
interface while the operator continues to edit another fiie. 


Examsple: 


PASS RJE -LOG 
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READY 

Syntax: 


> sea wana aoe@ READY -— =n ee <tisn> See ee eee aeeenaanesseconenaaoaneaensee) f 
l-- <station-name> -->! 
semantics: 


READY 1s valid from alt stations. It causes a change request to 
be sent to the handler for <isn> READY to be set to i. 


At BOJ» all stations are assumed to be online. Notification fron 
the Network controttler that a station is not responding witl be 


displayed during the SMCS initialization stage. If a station 
becomes responsive or aready for that station is entered» it 
widi be marked online. When any previously ontine station is 


reported as not responding by the Network controller» the SMCS 
displays "STATION <tsn> IS OFFLINE*® at the host ODT and the 
station is marked offline. 


The effect of this system is that the host operator can attempt 
to make a station ready and observe the success or failure of 
that attenpt. 
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REPORT 


Syntax: 


Pe Se 2219 0482 CF) 


> e®escavaeoonne RCEPORT ) OO SASS SOS C8288 CO DEBS SZ BST see eecaweaeaazeeeo)>f 


Form: 


REPORT 


REPORT ALL 


REPORT # 


REPORT > 


REPORT <station 


j-- ALL Sete seen eee eeeeecoweeeceea 5 | 
j-- 8 Sewers en aseeaeeaoaoecaecocoeoee= > | 


t-- <station identifier dist> -->! 


Semantics: 


Report a@l stations which are either logged 
on or attached to some progran. 


Report afi stations known. 


Count and report nurmber of stations either 
€ogged on of attached only. 


Report only the state of the station from 
which the command was received. 


identifier tlist> Report all vatid stations in 


the list. <A station identifier is a usercode 
or id active at the stations the station name 
or the tsn. 


This command is valid from alt stations. It displays information 
about all known stations. 


Example: 
E474 s “JOHN* ON JOB# 1234 “CANDE” 
1 STATION REPORTED AT 7345 7T/1T7I77 
If the requesting station is a controller or a remote ODT» then 


more information is provided. 


Examples: 


E474 
E576 
E678 
E789 
>E899 


COOT)=: <ONLINE> 
CC&0)s ON JOB# 1234 *CANDE* 
CCON): "GEORGE" | 
s (CUSER.YOU) ON JOBE 1244 "MEDIC" 
s CUSER.ME) <ONLINE> 


> STATIONS REPORTED AT 73245 T/LT/TT 
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BEMOVE 
Syntax: 


>>#e REMCOVE ) ee eaae <nusber> S228 OSV RSSHARBABDSSSSSGAHBVBAAHAM“®*A®**E GAA Aa2E02 >> 
jee ALL a aeoeee)» | j-- FROM =<» | {-- STATION o->} 
j-=- ONE sanvoeree > jf 


>> e®eeeeaaeoaon <isn> S22 eee eee eae eeenaaanevaacaavaenewocasvoe=) ff 


f-=-- <stationsname> --7>| 


Semantics: 


This coanand purges part or alt of the output queue of a given 
station. It is valid from ail controller stations. 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP Bi1000 SMCS 
SANTA BARBARA PLANT Pe Se 2219 0482 CF) 
SEND 

Syntax: 


2S SOND: Seer ee se See ee ALL eee eee ee ee ee er ee ee 
(oe 10. e274. [e200 “Sterner ee tess e2seeerrrrer eS 
i ' 
L ica Toe 6. Slee rern. -s 
(Se4e ores See e eer eles ee ane seseseeee= >> t 
f—- STATION --8 t-- <number> -->! 
I-- <name> ---->1 


> Dw ewan wet Gaevwaanwoaotvcaeanooaaeneana <message> esewvacanenvwroercoeee) f 


joo : =a@->j| 


Semantics: 


The SEND statement is used for sending messages and for message 
Switching. A message may be sent to ali stations on the network 
or to a select few. The stations are specified by their NDL name 
or by their dsne This command is valid from atl stations. 


SMCS queues messages for the appropriate station and sends an 
acknowledgment Cie@e» MESSAGE SENT) to the originating station. 
The acknowledgment does not iaply that all stations received the 
message. It merely signifies that messages were queued for 
output for the relevant stations. : 


Exanples: 


SEND ST3: HELLO 
SEND 203 3 HELLO 
SEND TO STATION ST5:3 HELLO 


HELLO is sent to station ST3 and to LSNs 2 and 3 and ST5e 
respectively. 


Hen eee eee ees ae ek wat he cera sh iad ec mnntiemld et cheddar tine exinen Le mrras Wnt bit wise enne rs lenis Sibert oldie 
ARM eeRT ecto NTN ernie EAE SE aC Rp net near a eraaraD maar eect eT a a oN Sh a 


sasthah AGS; vlan ReoVoet beh Thce okt ob Jeniehetttst dog tack ji eh GE Sb Sag ea td ALL Et a fun tc och ii esther Ura sshd Aaa gine rales Agha RA hah col fag N ange ict Seni he Uo ik i eA Blan echoed Stonebridge haf a 
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SIGNAL 


Syntax: 


Semantics: 


The SIGNAL command» vatid only from controtler stationse provides 
the user with the ability to change the signal character. For 
this command to effect the current signal characters no stations 
can be togged-on at the time the coamand is entered; otherwise 
it ais simaply rejected. 


3-29 


' BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP B1000 SNCS 
SANTA BARBARA PLANT Pe Se 2219 0482 CF) 
SIGN ON 
SIGN QEE 
Syntax: 


l ' t-- PROGRAM <-->! l-- <job nuaber> --! 
f-- SCIGN) -->1 | 3 
i 


j{-- OFF ee ene sen eer eeeseeceas cee aecoewowtaaseeazaeoeeee) ff 


t--> CLEAR -->! 


i | 


Semantics: 


SIGN ON 1s valid from ali stations except the host ODT.j~ The SIGN 
ON control message permits a station to attach itself to a user 
program. This program must be dectared in SMCS/JOBS (Csee 


Appendix A). A station can be attached to only one non=NCS 
program at atime. (Note: A station way be attached to several 
MCS*°s.) However » a user program may have several stations 


attached to it at the same time. 


When SMCS receives a SIGN ON message it goes through its program 
tables to determine if the program under consideration has been 
initiated. If the program has not been initiated» SMCS checks 
its job file for an entry for the specified <program id>. If 
founds SMCS executes it using the zip string associated with the 
entry for that <program id>» in SMCS/JOBS. SMCS then makes an 
appropriate entry in its program table. If not found» SMCS 
issues an error message. When the program comes into the mix it 
should open a remote file. This open is8 received by SMCS. SMCS 
then attaches all stations that were waiting to sign on to this 
program by approving the remote file open for these stations. 
The station then receives an acknowledgment message indicating 
that it is signed an. 


If the program has been initiated but the remote file open has 
not been received» then SMCS links this station to the other 
Stations waiting for the open of the given progran. 


If the program is currently executing and it has opened a remote 
fiie>» then the station is attached to that remote file by an 
attach command sent to the network controtler. The station then 
receives acknowledgment indicating that it is signed on. 


} 
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While a station is signed onto a user programs it say not sign on 
to another prograa. All messages entered from a signed on 
stations except for those which begin with a signal character» 
are sent directly to the user progran. Those messages which 
begin with a signal character are sent to SMCS. All messages 
written by the user program are sent to its stations. 


The optional <string> in SIGN ON» if supplied» will be sent to 
the progras which ts being signed on. An example of the use of 
this facility would be: 


SIGN ON CANDE MY/USER 


which would cause the station to be attached to CANDE and_ the 
input MY/USER queued to CANDE. If this ts a valid usercode and 
password coabinatione then CANDE witl tog the user on 
immediately. 


SIGN OFF ts also valid from att stations except the host ODT. To 
detach itself from a user programs a station must do a SIGN OFF. 
¥hen detachment is complete the station receives an 


acknowledgment that sign off is coapltlete. At this point’ the 
Station wii be at the same status as it was prior to its signing 
One The user program wifl receive an EOF branch from SMCS 


whenever its station count is zero (Cie@e» no stations are signed 
on to it and no stations which have PASSed are stitl togged on to 
SMCS). 


Semantics: CLEAR = the presence of this optional keyword wiit 
cause the station involved to be “cleared” 
from the MCP Remote File FIS8s which makes 
available to the systemp a station position 
which otherwise might be tied up. 


De fault: Standard station detachment. 
Examples: CIn this example» the user program is “CANDE".) 
Input: *-- «OFF 
Reply: *-- SIGNED OFF “"CANDE” 
Notes: Because the station signing-off is attached to an 
application program and the “SIGN OFF" ts a SNCS 


commands the SMCS "signal character” must prefix 
this command when entered. 


ye FREI cer RMT eS MRE CE CRT Ca ce ne ta cutie ale area gifge fa, 
is iy SSR A A a A 
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2TaTys 
Syntax: 


ERAT ee TEA er ce RM Re STE eeN a nS e UMO PRE SiN SPN ONE ECE Re See te PCN Tse OMCUnTEREY CTS OSCR OTT 


>ee STACTUS) OC SO @ O82 SFO © CBSO 6 O66 O22 822888 22 2E OO BOHESHBOBOT GBF FLA22e®) 


§ {== STATION “=> | j-- €<isn> se wave weave aoaosanecoee=) | 


| jo- €station nasze> eseaaneoaaaoeae) ] 
je- <user id> Sea evenness ceonee) | 
i | { 
j-- PROGRAN SO 228 OHSS SSS SHOT TEBE ESC BH GBA MH BeZeFeeZeee) | 
} joo“ <job number> es eaecoaaneoe) | | 
: | l-- <prograsg name> e-77°r°e=7>! 1 


t : 1 

je- FILE S see seoe cece ee Seeet es secon eae eeneaosoeoeaeea) | 
i-- <remote file number> -->]1 
jee <file name> seecovoeoewvoeee=)> | 


Semantics: 


The STATUS command is vatid from alt stations. It is used to 
determine the current status of a programs a file or a station. 


1. A STATUS PROGRAM coasand returns information on the following: 


Program name 

Program job number 

Remote file name and nuaber 

Remote fite status Copens not opened) 


2. A STATUS FILE command returns inforgjation on the foltowing: 


File nane 
Remote fille nuaber 
Open type 
Current stations 
Max stations perpitted 
GOODRESULTS ON or OFF 
SMCS control 
Protocol type» NO EOF status» NO.SCROLL status 
LOG ON status» EXCEPTION OK status» SESSIONS status 
PASS isn list 
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3. <A STATION status comgand returns information on the following: 


Logical 


Station 


SIGN ON 
Prograan 


Station Number CLSN) 
name 

status 

attachment Cif any) 


SMCS attachment Cif any) 
Signal character Cif not default) 
The vatue of the following NDL station attributes: 


Note: The 
the 


READY 

ENABLED 

TERMINAL TYPE 
BUFFER SIZE 

MYUSE 

ADDRESS 

TRAN NUMBER 
FREQUENCY 

RE TRIES 

QUTPUT MESSAGES 
LOGICALACK STATUS 
DIAGNOSTIC REQUEST STATUS 
GOOD RESULTS STATUS 
PRIMARY FILE 
SECONDARY FILE 
STATION PHONE 
CURRENT LINE # 
NUMBER OF LINES 
LINE INFORMATION 
TRANSLATE STATUS 
AUDIT STATUS 


default for STATUS ts STATIONs which then defaults to 
requesting LSN. If PROGRAM or FILE ts specified 


without a program name or a filenames then the program or 
file to which the requesting LSN is attached is assumed. 


ica TCA ck SSSR RIC SC i ont a se ea a: hn Oates elie e Nona ALAA ead od Rg Nr RN 
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atop 

syntax s 


Semantics: 


The STOP command is valid at the host ODT only. It prevents any 
further LOG"ON» SIGN-“ON» AYTACHs PASS» or any other active 
commande 


A message is sent to alt users requesting that they log-off. 
SMCS displays alist of active stations on the ODT. After 
sending the messages SMCS will attempt to terminate every 30 
seconds or will terminate immediately when the tast user logs 
off. 


Ss 
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SYSTEN 
Syntax: 


Pome snn= SYSCTEN) coer ee cree nese n nnn w neem nce e een ene nneeeene=>F 
Pome e-==> TRANSLATE seen eee nneecennnnsn=>! 
I--> ON coneneeee=->! 
I--> OFF cecn------>! 


f ewe eeen) VERSI ON see eceeecnwaoeearoosoe==) | 


Semantics: 


The SYSTEM command is used to maintain the “systes-transt ate" 
parameter. In addition to display options»s a host ODT ts 
permitted to change the “systeactranslate” parameter. 


TRANSLATE = a keyword for “systea-translate”™. 

VERSION = a keyword for the SMCS‘'s “"version-td”. 
De faults No option specified assumes a “group” tnquiry. 
Examptes: (Display system information. ) 


Input: =-~ SYS 


Reply: *-- HOST NAMES SYSTEM] 
SYSTEM@TRANSLATE: ON 
SYSTEM“VERSION: B1000 SMCS MARK 10.0.00D 


€09/25780 14:26) 


Note: Atl system parameters are maintained on disk. 


Wen, Sols faye rs eke sat eb) me RO OT week IL ant i eo cet eee A A ee a cue ky adhd yl 
ei pst eer ENC eT ET TT CEH eee Ee aL eC ETE PET ee DAT ee OCR aN amie tier rer 
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TABS 
Syntax: 
4 
V 1 
mean ae @ @ ) gs eaaae 
t 7 i 
V ( 


Few aavavweoe TABC(S) @E2 eee eoeoaaan @ €nuaber> ese een weeoewtoaeweaeocoeeeceroee=> ft 
i i 
{ eecemn> COBOL ee weer as ee ewewoerececeoeoooeoce= |{ 
Jj ewew@mery> FORTRAN sewer eee ae ewan econeaeoe= | 
{ cee)» BASIC eo cee anew eaecanseoanwoeoocooees= | 
J eweee5 SBOL eee weer et eee ee weeeeoeeoeea= | 


Jj eoe2-)»5 MIL © Oe Sewer ee ee enema emwoaavece | 


J-r"-""> <start col> -- # <increments> ~! 


Semantics: 


This command is used to set the tab stops on a user"s terminal. 
When the COS0L parameter is used» tab stops wili be ptaced at 
Cursor positions 8» 122 16» 20» 2h» 28% 329 369 &0» bhe 4&8 and 
73. When the FORTRAN parameter is used» tab stops will be placed 
at cursor positions 9» 1559 199 235 27» 3ie 35» 392 &3> kh? and 75-~ 
When the BASIC parameter is used» tab stops will be placed at 
cursor positions 1» 6G» 10» L4e 18% 220 260 30+ Sho 38% 420 4&6 and 
B80. When the SDL parameter is used» tab stops witl be placed at 
the cursor positions 9» 113» 18% 235 28» 335 38s 435 &8s 530 58> 
63- 668» 73 and 78. When the MIL parameter is used» tab stops 
wilt be placed at cursor positions 9» 15 and 48. A starting 
cotuan position and increment can aiso be specified. | 


Example: (To set tab stops at cursor positions 10 and 20.) 
ainputs: “-- TAB 10+ 20 


Reply: °-- # 


Z iy Bl yaa ual a a 
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TERMINATE 

Syntax: 


TERMINATE — SOAR OOO SSS SORTS SSS eS eces eases eee eeoeeeeees= j 


Semantics: 


The TERMINATE command is used to terminate the Station's 
currently running step macro. 
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TRACE 
Syntax: 

t-- ON -=>1 

j-- OFF ==>) 

i- DISK =>2 

i> MARK ->4 

j- LIST =>4 


Semantics: 


The TRACE command provides a trace capability for atl data that 
is either read or written by the SMCS remote file. It ts valid 
oniy from a controlier station or the host ODT. The ON option 
initiates printer tracing. If no option is specified, the 
Current status of “trace” is displayed. The OFF option causes 
tracing to be stopped. When the DISK option is specified» the 
SMCS will commence 1/0 tracing to the disk trace fille. The file 
is of a rotary type which timits the amount of disk space 
consumed. Printing of the disk trace file will be via the DMPALL 
utility program. The NARK option provides the facility to write 
a “marker” record into the trace files for whatever reasone 


Defauits — If no option is specified or the option — 
invalid» a “status* request is assumed. 
Example 1: (Obtain current TRACE status.) 
Input: e-- TRACE 
Reptys s-- CURRENT TRACE STATE = ON/DISK (<count>) 
Example 2: (Print the DISK trace fite.) 
Inputs s-" TRACE LIST 


Repty: *-- TRACE FILE PRINT INITIATED 


‘ 
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TRANSLATE 

Syntax: 


Peeseneoee TRANC SLATE) SS ee et Cl SSS See ee => Jz 
I-- ON --->1 
l-- OFF -->! 


Semantics: 


TRANSLATE>s valid from atl stations» is used to force att lower 


case characters in the input message into upper case. The ON 
option sets a flag for the station and all further input accepted 
from the station with be transtated. No option specified 


displays the current setting of the transtate ftag. The OFF 


option is used to turn translating “off". 


Notes This command can be entered to the SMCS with either a 
upper case or lower case command string. 


SONATE Uc euaooneos init r cor eare h P a OR ERO 
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USER 

iD 

Syntax: 


I-- <command> -->! 


I-- <coamand> -=>1] 


Semantics: 


These commands are vatid from ali stations except the host ODT. 
After being entered» <usercode>/<password> wild be validated and 


then used on alt MCP (€?) communications. <Identifier> or 
<usercode>/<password> wiil be stored and used for station 
identification. The cogmand is optional; however» if it is 


supplied» it will be taken as a norgal input to the SMCS after 
log-on is complete. 


If either <usercode>/<password> or <identifier> is already 
logged-on» Cat some other station) the current lLog-on attempt 
waid be allowed. The new station will be advised that other 


stations are already logged-on under the same <ID> or ¢cUS>. Att 
messages directed by usercode or id wilt go to atk stations 
having that usercode or id. 


If the station itis currentty togged ons the ftog-on witt 
automatically cause tog-roff of the previous user or id. The new 
usercode or id will then be logged-on as usual. 
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ZIe 

Syntax: 


Semantics: 

ZIP ws vatid frog all remote ODT stations except the host ODT. 
The command may be abbreviated as Z» however that is optional. 
<String> is sent to the MCP and any response froa the MCP is sent 
to one terminal. 


This command ts supplied to enable the user to send MCP. strings 
which begin with a vatid SMCS command such as US. 


Any input from a remote ODT station which is found not to be a 
valid SNCS command and whose first token is either a number or 
characters» is passed to the MCP automatically. 

The <string> will be unsecure» meaning that it will not have a 
usercode associated with it Cuntless "US" is part of <string>). 
Valid examples: 


Z EX DMPALL 


ZIP US ME/A EX DMPALL 


3740 


PER ae mane etd Nee ora Meee NN nore oe 
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2 

Syntax: 


> e®& een eae ? nana @ <string> eee COS C8 SS CAMB Be Cee ecewBeeeeaweoceececaece)> f 


Semantics: 


This coasand is valid from all stations except the host ODT. To 
use it» the station must be logged-on via the US command or be 
designated as aremote ODT. If the station is not a remote O0f 
but ts logged on with a valid usercode and passwords <string> is 
zipped to the MCP with usercode/password and *"RR1". 


<String> will be secures meaning *?MX" will return the user's aix 
only» if the station is logged on. 


If the station is a remote ODI and not lLogged-ons <string> will 
be zipped without a usercode and "RRO". A remote ODY that is 
fogged-on will cause the <string> to be zipped "secure"™> the 
same as for a noneremote ODT. 
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APPENDIX A = JOB FILE 


If a file exists named SMCS/JOBS» then it is used to execute jobs 
under certain supplied specifications. The file contains data 
concerning a particular job to be run in cooperation with the 
SMCS When a SIGN ON or PASS input command occurss SMCS will 
check the information in the job file for any defaults» special 


needs» etc. 


before executing the job. 


The job file is a disk data fite (UPL type)» each physical record 
consisting of 90 characters» twenty records per block. Comments 


are allowed 


in the file. Anything to the right of a percent sign 


(Z) is ignored. Each togical entry in the job file consists of 
one or more physicat records having the following format. 


Syntax: 


i-C1)-- 
i-(C1)-- 
i-C1l)-- 
i-C1l)-- 
r=Cij)-* 
i-C1)-- 
i-(1)-- 
f-C1)-- 
j 


om Gwe ap’ amen eam 


1-(L)---- USERCODE 


LOGON sooner nena cnn nnn enn conn nn cn en nnn wenn nnn c cnn ecn=| 
EXCEPT soccer e nen nnn cern cnn nen nnn nnn nen ncn n cen ncnncnn==| 
NO“SCROLL sone nner n enn n nnn n nnn nnn enn cece nn enc enennenne|} 
NOTRR teem reser ne nee nn enw nn cen ne nnn nc nnn econ ene cecenene=| 


AUT o-Ssf ART Se eannoaane Sa naa senwecee eee ecoecen esac eae eocoeea | 


COPIES = <integer> seer ecoeser cece e ecco e cme ccc cococoas=] 
MESSAGES ote seen cen cn www we cm ee cece weno eee eee onc asaa= | 
NO=EOE Seer eal ere sen Seer ees ee eee ss Ree eee eee ae 
i i 

i= © Saeeeres erasers ses seers" <seconds> 2) i. I 

l i j t 

d i-- <minutes>: -I ! 

§ ] { 

i-- <hours>: <1 i 

Q 


i i 7 | 
im <parttai-usercode>? ----! | 
i 


i i 
im-- € <us>/<pw> ) =I 


- USERFILE 
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Where the Syntax for the useerfile records is as follows: 


§ Cewaeuvoenea 


i 
l-- <par 


8 
tialrusercode>? *<«-----| 


Note: <program id> may be up to 32 characters in length. 


Except for 
character 1 
blanks)» 
records in 
Semantics: 


NO~EOF 


NOWSCROLL 


LOG-ON 


the fact that the "$* must be the very first 
n a job specification (Ci.ee» 
this is totatly free format a 


the jobs file. 


SMCS will not send an EOF°BRANCH 
the job after all signed-on stations have been 
detached and alt stations having 
logged off SNCS. SMCS allows a timer value to 
be specified on the NO-EOF option in the jobs 
file. If a timer is specifieds SMCS will wait 
that amount of time before sending the EOF 
branch to the program. The hours» aerinutes»e 
and seconds fields must be integer values. 


Any station signing on to 


the 


program wilt automaticatty be 
scroil and after sign o f f 
automaticatty put back tnto scroll Cif tt was 


1n scroll before sign on). 


When a station signs on to 


the 


no teading 
nd way cross 


message to 


PASSed have 


associated 
taken out of 
widi be 


associated 


progr an» if the station is logged on with a 


valid usercode and password» 
usercode and password will 
first input to the program. 


be 


then that 
sent as the 
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EXCEPT 


NO-RR 


AUTO“START 


COPIES = 


MESSAGES 


USERCODE 


USERFILE 


<integer> 


Pe Se 2219 0482 CF) 


When a Station is Signed off via "#SEIGN OFF ">s 
an exception-branch 1s caused on the 
associated program. 


The associated program is to be executed 
without "RR" being set. 


The assoctated programs is spawned during SNCS 
initialization processing. 


The maxigwum number of copies that will be 
spawned is specified by <integer>. 


The LS boolean is set when the job is spawned» 
and all stations signed on to the progran 
receive alt ODT output messages for the 
program. 


SMCS allows a job» signed on to or passed to» 
to be dtimited to certain. usercodes. If onty 
one usercode is to be allowed to sign on or 
pass to the job» the USERCODE option is used? 
tf more than one usercode is allowed to sign 
on or pass to the jobs the USERFILE option is 
used. 


The USERFILE option specifies the name of the 
file which contains. the set of usercodes 
allowed. The record tength of the file aust 
be tess than or equal to 90 characters and 
only the first 72 bytes of the record are 
looked at. If a usercode/password is required 
to access the fites Cielo» the file is 
private) the usercode/password required to 
access the file must be specified following 


the userfile option:s*(<us>/<pu>)*. 


A partiat usercode may be specified for the 
usercode option and partial usercodes may be 
specified in the userfite. For examples if 
"USERCODE = CA?" ts specified in the jobs file 
for a job» onty the stations logged on with a 
usercode beginning with the letters "CA* wilt 
be allowed to SIGN ON or PASS to the progran. 


Aw4 
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Sample job files 


S$ WMAK NO“RR> EX MAK> 

$ CANDE NO-EOF LOG"ON EXCEPT NO-RR AUTO“STARTS 
US ABC EX CANDEsS ME 57605PR 135PT 

$ RL> 
US ABC EX REMOTE/LISTERs PR 125FI RMT PTL 3 

$ SYCOM NO-EOF LOG°ON EXCEPT NO-RR AUTO“START; 
EX SYCOMs PR &2s5FI LONK NAM HUBLINK 

$ RD NOWEOF NOWSCROLL LOG*ON EXCEPT AUTOSTART; 
EX RDs PP L&sMP 7 


In this exaaple: 


SMCS uses <¢program id> in its “"aons*™ and "passes". If 
someone does an “ON RL™ they will ‘become attached to the 
program REMOTE/LISTER. If someone does an "ON 


REMOTE/LISTER™ they witt get the error message 
“"REMOTE/LISTER® NOT IN THE JO8S FILE™. 


The <program id> for RD must be "RD" for *J"» “MX"%» and "WY" 
to be automatically forwarded to RD. 


Examples 

SIGN ON X/Y¥Y => EX A FI L NO HARs 

JOBS FILE record - $X/Ys EX A FI L NO HAR> 

PASS A/B/C <x> => US QT/PW EX D/Es SWO=15 FILE A DSK DEF 

JOBS FILE record =~ S$A/B/C; US OT/PH EX D/E> SWO=1> FILE A OSK DEF 
Note: The job file may be. created using an editor or using 
| OMPALL through the card reader. The file must be 90 


characters per record. To use DMPALL» one must supply 
"DATA" and "END" cards. | 
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APPENDIX 8 = MAIL SYSTEM 


A file named MAIL/<dayname> is smaintained by the MCS. <Daynasme> 
is the name of the current day. Entries to it will be wade when 
the MCS receives: 


- Standard ODT output for a user 
- PROGRAM“PASS input (type 60). 


The file is seriat» disk» 80 characters per record» 9 records per 
block and capabie of being read by any progran. This atlows an 
editor such as CANDE to LIST or FIND on the fite or OMPALL to 
create a separate file of setected records. SMCS currently 
contains no facility to retrieve MAIL entries (See Note 3» this 
section). 


The format of each matt file entry is: 


Length 
Field COBOL PIC Format Description 
iD XC 10) Message identification as specified 
in PROGRAM°PASS input message. This 
id wiil normatity be a usercode but 
may be the first 10 characters of a 
program name in literal fora. 
Exaaples: 7 
GEORGE Ca usercode) 
RJE Ca prograa name) 
TOSOO0/EDIT Ca program name) 
RJE/CONTRO (the first 10 
characters of a program name = 
RJE/CONTROLLER) 


FILLER x Bl ank 


TIME x(5) The time of entry of this message 
to the mail fite. The form is HH: MM 
where HH ts the 2 character military 
hour value and MM 3s the 2 character 
minute value. 


FILLER xX Blank 


MESSAGE X(63) The message (tleftcjustified tn the 
fieid). Any wsessage longer than 

63 characters wiil be broken into 

63 character pieces and placed 

conti guously in the amaittl fite 

With identical 1D and time fietds. 
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Note 1: At BOJ»s the file will be created if it does not already 


Note 2: 


Note 35 


exist. If it exists» it witt be opened and spaced to EOF 
where new entries will be made. When 8192 records have 
been written to the file» it will be closed tock and an 
attempt wifl be made to create a new wail file naaed 
MAIL/TODAY. If this file already exists and is dated 
today or has been opened by some other programs then SMCS 
will display a message informing the operator of this 
condition and will not write any messages until the file 
is released. 


At midnight» SMCS will automatically close its current 
mail file lock and open a new day*s file. Note that this 
allows six days* previous gait files and today's full 
file> plus an overflow file (CMAIL/TODAY) to exist 
simultaneously. 


Currently» SMCS only makes entries to the file» there 1s 
no mechanisa to remove them other than the automatic 
removal of the entire file after seven dayse- fhe process 
of removing entries is sufficiently cosaptex Cif tt ts to 
provide any reasonable set of user-specified operations 
on the file) that it should be performed outside of the 
SNCS. The concept of a “Mail Handler*™ program is 
suggested as the right way to provide a full» complete 
"MAIL™ systene Such a program does not exist at this 
time» but will be the subject of future enhancements. 


Wisden 
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APPENDIX € = PROGRAN=PASS MESSAGES 
PROGRAM=PASS INPUT MESSAGE 


Written bys Application progran 

Read bys: MCS 

Purposes: Transfer a message from a programs to a station 
under direction of the MCS. 

Format: The message consists of two parts: 


- A header Cfor remote files with headers) or 
a Key (for remote files with remote key) 


- Text 
HEADER FORMAT 
Length 
Field CCOBOL PIC Format) Description 
MESSAGE TYPE 99 "60" 
FILLER X 
LSN 999 Logical station nusber 
MESSAGE TEXT SIZE 9999 Numeric input required 
DESTINATION REMOTE 
FILE NUMBER 999 The file to which the message sust 
7 be sent (the MCS*s remote file) 
FILLER X(37) 
KEY FORMAT 
Fieid Length Description 
RSN 999. File-rel ative station number 
MESSAGE TEXT SIZE 9999 Numeric input required 


MESSAGE TYPE 999 Must be 7060" 


BURROUGHS CORPORATION 
COMPUTER SYSTENS GROUP 
SANTA BARBARA PLANT 


TEXT FORMAT 


Field Length 
SUB TYPE 99 
SUB WARIANT 9 

£D X¥C30) 
FILLER X(10) 
SUB TEXT 


The ID feeid varies depending on sub type as follows: 


SUB TYPE 


00 


01 


02 


03 


04 


05 


XCMESSAGE TEXT 


{0 FIELDS 


FILLER 
USERCODE INDEX 


FILLER 
REMOTE FILE NO. 


FILLER 
USERCODE 


FILLER 
PROGRAM NAME 


USER ID 
FILLER 


LENGTH 
PIC 


X(30) 


9999 


X(26) 
999 


X€27) 
X€10) 


X¥(€20) 
X¥€30) 


X¥€10) 
X(€20) 


Indicates 
indicates 
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Description 


DESTINATION 
DESCRIPTION 


LSN 

Station(s) with 
this usercode 
index 


Station (s) 


attached to this 


remote file no. 
Station (s) 
Logged on under 
this usercode 


Station(s) 


attached to this 


prograa 


destination stations 
mail file destination 
Information used in deteraining 
destinations dependent on sub Eyes 
Reserved for future use 

SIZE = &3) 
Actuai text of the message 


MAIL ID 


Usercode or [ID 
if present*t 
Usercodes 


Usercode or ID 


if presents 


Usercodes 


Program nase 


Mail or MCS only User ID 


*If destination cannot be founds then the message cannot be 
mailed or sent to any station. 


The sub variant field indicates special 


SUB VARIANT 


0 


l 
2 
3 


Description 


destination as foitlows: 


Send to destination as specified by sub type 
and put in mail file 
2end to destination only 
Put in mail file only 


No destinations no mail file. 


the MCS only. 
to the MCS - no taplementation as yet.) 


Message is for 
(Program direct cosrgunication 


i 


BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 


SANTA BARBARA 


PLANT 


PROGRAM=P435 OUTPUT MESSAGE 


Written by: 
Read by 3: 
Purpose: 


Format: 


MCS 
Application program 


csalgnchcesatteenihe 


C 


COMPANY CONFIDENTIAL 
81000 SMCS 


Pe Se 2219 0482 (F) 


Transfer a message from a station under control 


of the MCS to a prograa. 


The message is foragatted 


according to OPEN-PROTOCOL.TYPE as specified in 
the prograa*s remote file. 

The message consists of two parts? 

- A header (for remote files with headers) or a 
key (for remote files with remote key) 


- Text 


HEADER FORMAT 


Fietd 


MESSAGE TYPE 


FILLER 
LSN 


MESSAGE TEXT SIZE 
DESTINATION 
FILE NUMBER 


FILLER 


KEY FORMAT 


Fietd 


RSN 


MESSAGE TEXT SIZE 
MESSAGE TYPE 


Length 
CCOBOL PIC Format) 
99 
x 
999 
9999 
REMOTE 
999 


X(37) 


Length 
999 
9999 
999 


Description 


Logical station number 


The file to which the message aust 


be sent Capplication file) 


Description 


File-relative station nusber 


Must be *06i1*°% 
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TEXT FORMAT 


Text ts dependent upon OPEN-PROTOCOL.TYPE. 


PROTOCOL TYPE FIELD LENGTH DESCRIPTION 

09 CInvalid for PROGRAN“PASS 
Output message. SMCS wilt 
send messages by type "01" 
instead of "61" when a 
station PASSes to a program 
whose OPEN.PROTOCOL.YYPE is 
0.) | 


{ 


01 USERCODE INDEX 9999 Usercode index of user 
for whoa this sgessage 
as destined. 


FILLER. X(10) Future use 

SUB TEXT XCMESSAGE TEXY SIZE -14) 
02 FAMILY.ID XC10) 

"MCPQ or 

a4# <nuaber>* X€10) 

USERCODE XC10) 

PASSWORD X€10) 

USERCODE INDEX . 

or BLANKS X(€4) 

SINGLE CHARACTER X€1) 

BLANKS X(9) 

SUB TEXT XCMESSAGE TEST SIZE 54) 


03 


04-09 Reserved for future use 
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APPENDIX D = HACRO PROCEDURES 
GENERAL 


The invocation of MACRO procedures enable the user to zip lengthy 
MCP control strings or enter SNCS commands without having to 
enter the entire string or coarmand. This is specially useful 
with control strings that require numerous file equations» or 
with a series of control strings that are to be executed fottouned 
by optionat parameters and their replacement strings delimted by 
square brackets ({ J). Once the MACRO procedure has been 
expanded out by the SMCS program» the controt string is treated 
as though the user had entered it directly. A MACRO tnvocation 
can appear in a control string zipped from a workstations 
controller station» or aremote ODY station. MACRO invocations 
can also appear in unsecured control strings zipped from a rerote 
ODT station. 


MACRO CREATION 


MACRO procedures are created using the MACRO coasand or they can 
reside in a file under the stations®s usercode. 


MACRO INVOCATION 


A MACRO procedure is invoked by enclosing the name of the MACRO 
procedure in square brackets ({ ]) atong with any parameters and 
their replacement stringse The first token after the teft 
bracket (Cf) ts the MACRO name. The SMCS orogram first searches 
for the MACRO procedure tn the SMCS/DIRECTORY fite under the 


station*s usercode. If the MACRO name iis not found in the 
SMCS/DIRECTORY file» the SMCS program attempts to open up a file 
using the MACRO name and the station*s usercode. If the file is 


not present» the brackets are ignored. The SNCS program then 
scans the MACRO procedure for the parameters. If a parameter is 
founds it ts replaced by the reptacement'= string. The SNCS 
program then concatentates the text portion of the records tn the 
MACRO procedure and removes extra blanks to produce ae text 
string. If a percent sign (€2Z) is found tn a records the 
remaining text in the record is not scanned. SMCS wilt not scan 
for "C€" ina PASS string. The following are exanpies of MACRO 
procedures and the resultant zip strings with and without 
parameters. 


Exampte i (without paraseters): 
MACRO procedure MIX contains: 
ML > 


MX> 
WY > 
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WS =/=> 


Entering #Z CMIX] causes the following control string to be 
zipped to the NCP> 


ZIP QU SMCS/MCPQ LS SZ 21 RR O ML3 MX3 WY3 WS =s23 


The result is returned to the terminat from which the command 
originated. 


The previous example shows how a user can zip often-used 
combinations of ODT commands with one command. However» conpite 
and execute strings usuatly use a standard format with a file 
name substitued throughout the file equations. This type of 
operation can be accoaplished using MCARO parameter. 


Example 2 (with parameters): 


The MACRO procedure COBOL contains: 


COMPILE P COBOL LIBRARY>» 
FILE CARDS DSK NAME P.S> 
FILE LINE U.N NO HAR NO ATP NAME #P3 


Entering * (COBOL P TEST] causes the following control string to 
be zipped to the MCP: 


ZIP QU SMCS/MCPQ LS SZ 21 RR 1 US TIO/S COMPELE TEST COBOL 
LIBRARYs FILE CARDS DSK NAME TEST.Ss FILE LINE U.N NO HAR 
NO ATP NAME #TEST> | 


In this example>s the parameter itis the token "'P" and the 
replacement string ts “TEST*%. The period in the tokens "P.S"s is 
used as a delimiter for a token search. The vatid delimiters 
ares 


<space> = ** €( ) #%s 2%.» * » §' = { Jj 
The above delimiters» when encountered by the SNCS program are 
left tin the controt string. A special detimiter exists that is 
not put nthe control string. This is Uti dettaiter. In the 
second exaaple» if the tokens P.Ss was PIISs the replacement 
string ts TESTS instead of TEST.S. 


NOTE s The vertical bar character (1) is created by entering an 


exclamation point Cuppercase 1) on a MY 983/TD 830.TD 820 


terminat. it is represented by the EBCDIC code a4Fa. 


Combinations of multiple MACRO tnvocations and text can be zipped 
in one control strings For example» using the MACRO procedure in 
the second example» the following can be invoked: | 
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« WT CCOBOL P TEST1)3 THEN CCOBOL P TEST2]: 
This produces the fotlowing controt string: 


ZIP QU SMCS/MCPQ LS SZ 21 RR 1 US TIO/ WTS COMPILE TEST1 
COBOL LIBRARYS FILE CARDS DSK NAME TEST1.$5 FILE LINE 
UeN NO HAR NO ATP NAME #TEST1>5 THEN COMPILE TEST2 COBOL 
LIBRARY> FILL CARDS DSK NAME TEST2.S5 FILE CINE U.N NO 
HAR NO ATP NAME #TEST2; 


A MACRO invocation can invoke another MACRO procedure. For 
example» the MACRO procedures Ce contains the following: i 
COMPILE X Y LIBRARY: 
FILE CARDS NAME X1UIESRC; 
The MACRO procedures NOW» contains the following invocation of 
the MACRO procedure C3: 


{C X PAYROLL Y COBOL) 


The invocation of the MACRO NOW» (CNOW]> produces the following 
MCP control string: 


ZIP QU SMCS/MCPQ LS SZ 21 RR 1 US TIO COMPILE PAYROLL 
COBOL LIBRARYs FILE CARDS OSK NAME PAYROLLSRC3 
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Macro procedures can also invoke SMCS commands. For exaauples if 
the MACRO procedures» SETTABS» contains the following: 


TABS 9 20 30 40 50 60 70 80 
The invocation of this MACRO procedures ([SETTABS]» causes the TAB 


stops to be sete Using the TABS comagpand in a MACRO procedure can 
be especialiy useful to the RPG programmer. 


RESTRICTIONS 


The fotlowing restrictions exist in creating and tnvoking MACRO 
procedures: 


Le The length of the MACRO procedure entered by the MACRO 
ADD or the MACRO CHANGE command cannot exceed 23 tines. 


2 The tength of the control string spawned as a result of 
a MACRO invocation cannot exceed 1000 characters. 


3 Colusn 80 of the MACRO procedure entered by the MACRO 
ACD or the MACRO CHANGE commands must be biank. Cotuan 
80 is reserved for step macros. | 


Le There can be up to 10 parameters in each MACRO 
procedure. 


5. The SMCS program does not scan for MACRO invocations tn 
the PASS or MACRO commands. 


6 » A parameter is limited to ten characters. 


Te The replacement field of a parameter is limited to ten 
characterse 
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STEP MACROS 


Coluan etghty aust be non blank to signify a stepe A step can be 
a record destined for the MCP» remote fiie or SMCS itself. After 
SMCS recognizes a step» if the first character is not a signal 
character and this station is attached (Cor in the process of 
being attached) to a remote files the data is given to the remote 
file as normat input. If the first character is the signat. 
character or if no remote file is attached to this stations SMCS 
will act on this step. It wilt check colusns one and two (Ctwo 
and three if a signal character was present) for two pound signs 
C##). If no match was found SMCS watt treat it as any other 
input from a terninal. That is» took to see if it is an SMCS 
command and act upon it if it is» otherwise zip it off to the 
MCP. If #2 was found SMCS will expect one of the step coasmsands 
to follow on the same record. Yhis is the syntax and saeaning for 
the step coamands. 


eeea 2 ane NULL O88 82 6828S E28 882282 2BHTSHHBAHRVBAAABA“S“BABAOEO® C¢ 


i 
l- TERMINATE ae sense eevee eeee sv eee sen eeeecosee= { 
1 ! 
{- GOTO eSeea sonavonanaaea <integer> Se aan eaaoaneane | 
i 3 i-= 4 == i 
ee t 
1 i 
{- WAIT —_- ATTACH see eeeeeawese ca eweceeaeece | 
{ i 
{- DETACH Bee sew eee ee ee eees ewe seeoe | 
| i 
j- CONTINUE eee ceveseoneesoes coeesoa | 
i t 
{- FOR SQee @e enn aeoanoneananane <tipme> ao | 
j { t 


i- UNTIL weave ewocoroecce= } | 
i 1 i | i 
i {- <date>. -i i 
| 1 
i- job Sees aeere eet eevee ecoeoceneceseoeeee {| 
NULL SMCS wild just read the next step in the step 
gBacroe 
TERMINATE SMCS will terminate the step sacro. 
GOTO This command will cause SMCS to read the indicated 


relative (to one) record as the next step in the 
Step macro. SMCS puts some constraints on the use 
of this command so it wilt not loop. I[t will work 
effectively when used in conjunction with the WAIT 
job option. 
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WAIT 


WAIT ATTACH 


WAIT DETACH 


WALT CONTINUE 


WAIT FOR 


If a WAIT is successfully executed» SMCS will 
suspend processing the step macro. When the WAIT 
event comes true SMCS witl start at the next step 
of the step macro Cexcept for WAIT job). 


The step macro is suspended untit SMCS becosmes the 
secondary. If SMCS was already the secondary it 
will be treated as a NULL. 


The step wacro is suspended until SMCS becomes the 
primary. If SMCS was stready the primary this 
command witt be treated as a NULL. 


The step emacro with be suspended until the 
CONTINUE command is entered at the terminal. 


The format of time is 


i | i 
i | 
errr <integer 3> =--] 
1 Cainutes) 
{ 


-- <integer <> --| 


Chours) 


WAIT UNTIL 


The processing of this step macro will be 
suspended for this amount of time. | 


The format of date is smonth/day/year. The 
processing of this step macro wiit be suspended 
until this time and day. 
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WAIT job If the token following WAIT is not one of the key 


words ATTACH» DETACHs CONTENUEs FOR or UNTIL it 
witi be taken as a string to be zipped to the NCP. 
This string itself may be a siupte macro and would 
be expanded accordingly before the zip. If this 
zip caused at least one job to be executed» the 
job number of the first schedule record read witt 
be stored. Any others will be ignored. SMCS witl 
then suspend this step macro until an EQJ record 
with the matching job number is read. When the 
step macro is started again» it will be started at 
the next record if the EQJ was norrval with no 
syntax errors» the next record ¢ 1 if it was an 
abnormal EOJ or the next record ¢ 2 if it was a 
normal EOJ but had syntax errors. 


If a step of a step macro is not a WAIT» the step macro is not 
suspended» the next step will be read. The step macro will be 
terminated after the fast record is processed (if it was not a 
GOTO). j 


Step macros will not work from macros in a disk file. The size 
of the replace from and to fields has changed. They are 5 and 15 
characters respectively. 


Here are some examples of a step macro. 


MACRO ADD CYCLE 


* OFF & 1 Log off any program you might be on. 

*®#8WAIT DETACH Z 2 Wait for the detach to occur. 

ON CANDE G X Z 3 Log on to CANDE and get the source. 

P 0 % 4 Get a page of source. 

###WAIT CONTINUE Z 5 Wait till I stop making changes. 

SAVE % 6 [Issue a SAVE. 

BYE 2 @ Issue a BYE. 

*e##WAIT DETACH 2 8 Wait for the detach to occur. 

ay X Z 9 Issue macro Y with source Xe This record 
will become more clear when this macro is 
used in conjunction with the next macro. 

*{RD)  £ 10 Back to RD. 


In a macro it is important when and when not to use a signat 
character. Use a signal character when you want this step of the. 
macro to be processed by SNCS and there is a chance a reacte file 
might be attached Cin the primary slot). These examples 
hopefully can give you sose indication when a signat character 
can be used. 


The invocation of the previous macro» CYCLE» tooks tike {CYCLE xX 
SOURCE Y <MACRO>]. If I am repeatedly working on one source file 
then I will create another macro to invoke CYCLE} [If looks Likes 
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MACRO ADO CC 

{CYCLE X SOURCE“NAME Y COCTR) O 1700) 

$o now I just type in #{CC)] to start editing. 

Another macro involving a compile might look like; 


MACRO ADD BC 


aOFF Z i Log off whatever you might be on. 

*##@WaAIT DETACH Z 2 Wait for detach or a BYE from RL. 

ON CANDE G X49ISRC Z 3 On to CANDE and get source fite. 

P C Z 4& Get a page. 

@ZZ2WAIT CONTINUE Z% 5S Wait for CONTINUE coamand. 

SAVE Z 6 Issue SAVE. 

BYE 2 @ Issue BYE. 

*##WAIT DETACH XZ 8 Wait for detach. 

CRO] 2 9 Back to RO. I teave my terminal on RD. 
*@Z#WAIT €C) Z 10 Suspend macro until compile is done. 
@®#STERMINATE Z 11 NORMAL EQJ | 
*##NULL 2 12 ABNORMAL E03 DS DP. Fatt thru to next step. 
* OFF % 13 SYNTAX ERRORS. Log off RD. | 

@#8WAIT DETACH 214 Wait for detach. 

EX RL Z15 Execute RL. 

## WAIT ATTACH Z 16 Wait for RL to become attached. 

G XIIBKP Z 17 Get the backup file. | 

ERR 2 18 Look for errors. 

*##GOTO 2 2 20 Go back and wait for the BYE. 

Records 10 thru 13 show the use of the “WAIT job" option. The 


invocation of this sgacro would be {[{B8C X TST]. Replace att 
occurences on X with TST.» the source file nase. It ts isportant 
to point out that the replace operation (X with TST) witl take 
place on any internal macro invocations as welt and witt be 
remembered thru suspensions. 
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